Skip to content

update to semconv v1.26.0 and use stable attributes#55

Open
thaJeztah wants to merge 1 commit intocontainerd:mainfrom
thaJeztah:bump_semconv
Open

update to semconv v1.26.0 and use stable attributes#55
thaJeztah wants to merge 1 commit intocontainerd:mainfrom
thaJeztah:bump_semconv

Conversation

@thaJeztah
Copy link
Copy Markdown
Member

Update to the semconv version used by go.opentelemetry.io/otel v1.21.0, and update to use stable attributes;

  • NetSockPeerAddr (net.sock.peer.addr) -> NetworkPeerAddress (network.peer.address)
  • NetSockPeerPort (net.sock.peer.port) -> NetworkPeerPort (network.peer.port)

Unfortunately, there's no good replacement for NetPeerName (net.peer.name) and NetPeerPort (net.peer.port). The network.peer.address attribute should strictly only be used for IP-addresses or socket addresses, but the description is slightly ambiguous;

network.peer.address and network.local.address should be IP addresses, Unix
domain socket names, or other addresses specific to network type.

The alternatie is to use either "semconv.ClientAddress" + "semconv.ClientPort" or "semconv.ServerAddress" + "semconv.ServerPort" for hostnames. However, the code in this module is generic and doesn't distinguish between "client" and "server", and there's no equivalent for "peer address".

See https://opentelemetry.io/docs/specs/semconv/general/attributes/#other-network-attributes

Update to the semconv version used by go.opentelemetry.io/otel v1.21.0, and
update to use stable attributes;

- NetSockPeerAddr (net.sock.peer.addr) -> NetworkPeerAddress (network.peer.address)
- NetSockPeerPort (net.sock.peer.port) -> NetworkPeerPort (network.peer.port)

Unfortunately, there's no good replacement for NetPeerName (net.peer.name) and
NetPeerPort (net.peer.port). The `network.peer.address` attribute should strictly
only be used for IP-addresses or socket addresses, but the description is slightly
ambiguous;

> network.peer.address and network.local.address should be IP addresses, Unix
> domain socket names, or other addresses specific to network type.

The alternatie is to use either "semconv.ClientAddress" + "semconv.ClientPort"
or "semconv.ServerAddress" + "semconv.ServerPort" for hostnames. However, the
code in this module is generic and doesn't distinguish between "client" and
"server", and there's no equivalent for "peer address".

See https://opentelemetry.io/docs/specs/semconv/general/attributes/#other-network-attributes

Signed-off-by: Sebastiaan van Stijn <github@gone.nl>
@thaJeztah thaJeztah marked this pull request as ready for review December 17, 2025 10:21
@thaJeztah
Copy link
Copy Markdown
Member Author

@kiashok moving this one out of draft, but open to input / suggestions what the best approach would be for this; i.e., should we add the legacy ones as well (in addition to the new ones), or just switch over?

@kiashok
Copy link
Copy Markdown

kiashok commented Dec 20, 2025

@kiashok moving this one out of draft, but open to input / suggestions what the best approach would be for this; i.e., should we add the legacy ones as well (in addition to the new ones), or just switch over?

@thaJeztah I moved to a new team and don't work on containerd now.

@anmaxvl @msscotb could you please help with this? Thanks.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants